home *** CD-ROM | disk | FTP | other *** search
XXXXmmmmPPPPrrrroooocccceeeessssssssTTTTrrrraaaavvvveeeerrrrssssaaaallll((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmPPPPrrrroooocccceeeessssssssTTTTrrrraaaavvvveeeerrrrssssaaaallll((((3333XXXX)))) NNNNAAAAMMMMEEEE XXXXmmmmPPPPrrrroooocccceeeessssssssTTTTrrrraaaavvvveeeerrrrssssaaaallll - A function that determines which component receives keyboard events when a widget has the focus SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS ####iiiinnnncccclllluuuuddddeeee <<<<XXXXmmmm////XXXXmmmm....hhhh>>>> BBBBoooooooolllleeeeaaaannnn XXXXmmmmPPPPrrrroooocccceeeessssssssTTTTrrrraaaavvvveeeerrrrssssaaaallll ((((_w_i_d_g_e_t, _d_i_r_e_c_t_i_o_n)))) WWWWiiiiddddggggeeeetttt _w_i_d_g_e_t;;;; XXXXmmmmTTTTrrrraaaavvvveeeerrrrssssaaaallllDDDDiiiirrrreeeeccccttttiiiioooonnnn_d_i_r_e_c_t_i_o_n;;;; VVVVEEEERRRRSSSSIIIIOOOONNNN This page documents version 1.2 of the Motif library. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN XXXXmmmmPPPPrrrroooocccceeeessssssssTTTTrrrraaaavvvveeeerrrrssssaaaallll determines which component of a hierarchy receives keyboard events when the hierarchy that contains the given widget has keyboard focus. Using XXXXmmmmPPPPrrrroooocccceeeessssssssTTTTrrrraaaavvvveeeerrrrssssaaaallll to traverse to MenuBars, Pulldown MenuPanes, or Popup MenuPanes is not supported. _w_i_d_g_e_t Specifies the widget ID of the widget whose hierarchy is to be traversed. The hierarchy is only traversed up to the top of the shell. If that shell does not currently have the focus, any changes to the element with focus within that shell will not occur until the next time the shell recieves focus. _d_i_r_e_c_t_i_o_n Specifies the direction of traversal The _d_i_r_e_c_t_i_o_n parameter can have the following values, which cause the routine to take the corresponding actions: +o XXXXmmmmTTTTRRRRAAAAVVVVEEEERRRRSSSSEEEE____CCCCUUUURRRRRRRREEEENNNNTTTT-Finds the hierarchy and the tab group that contain _w_i_d_g_e_t. If this tab group is not the active tab group, makes it the active tab group. If _w_i_d_g_e_t is an item in the active tab group, makes it the active item. If _w_i_d_g_e_t is the active tab group, makes the first traversable item in the tab group the active item. +o XXXXmmmmTTTTRRRRAAAAVVVVEEEERRRRSSSSEEEE____DDDDOOOOWWWWNNNN-Finds the hierarchy that contains _w_i_d_g_e_t. Finds the active item in the active tab group and makes the item below it the active item. If there is no item below, wraps. Page 1 (printed 4/30/98) XXXXmmmmPPPPrrrroooocccceeeessssssssTTTTrrrraaaavvvveeeerrrrssssaaaallll((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmPPPPrrrroooocccceeeessssssssTTTTrrrraaaavvvveeeerrrrssssaaaallll((((3333XXXX)))) +o XXXXmmmmTTTTRRRRAAAAVVVVEEEERRRRSSSSEEEE____HHHHOOOOMMMMEEEE-Finds the hierarchy that contains _w_i_d_g_e_t. Finds the active item in the active tab group and makes the first traversable item in the tab group the active item. +o XXXXmmmmTTTTRRRRAAAAVVVVEEEERRRRSSSSEEEE____LLLLEEEEFFFFTTTT-Finds the hierarchy that contains _w_i_d_g_e_t. Finds the active item in the active tab group and makes the item to the left the active item. If there is no item to the left, wraps. +o XXXXmmmmTTTTRRRRAAAAVVVVEEEERRRRSSSSEEEE____NNNNEEEEXXXXTTTT-Finds the hierarchy that contains _w_i_d_g_e_t. Finds the active item in the active tab group and makes the next item in child order the active item. +o XXXXmmmmTTTTRRRRAAAAVVVVEEEERRRRSSSSEEEE____NNNNEEEEXXXXTTTT____TTTTAAAABBBB____GGGGRRRROOOOUUUUPPPP-Finds the hierarchy that contains _w_i_d_g_e_t. Finds the active tab group (if any) and makes the next tab group the active tab group in the hierarchy. +o XXXXmmmmTTTTRRRRAAAAVVVVEEEERRRRSSSSEEEE____PPPPRRRREEEEVVVV-Finds the hierarchy that contains _w_i_d_g_e_t. Finds the active item in the active tab group and makes the previous item in child order the active item. +o XXXXmmmmTTTTRRRRAAAAVVVVEEEERRRRSSSSEEEE____PPPPRRRREEEEVVVV____TTTTAAAABBBB____GGGGRRRROOOOUUUUPPPP-Finds the hierarchy that contains _w_i_d_g_e_t. Finds the active tab group (if any) and makes the previous tab group the active tab group in the hierarchy. +o XXXXmmmmTTTTRRRRAAAAVVVVEEEERRRRSSSSEEEE____RRRRIIIIGGGGHHHHTTTT-Finds the hierarchy that contains _w_i_d_g_e_t. Finds the active item in the active tab group and makes the item to the right the active item. If there is no item to the right, wraps. +o XXXXmmmmTTTTRRRRAAAAVVVVEEEERRRRSSSSEEEE____UUUUPPPP-Finds the hierarchy that contains _w_i_d_g_e_t. Finds the active item in the active tab group and makes the item above it the active item. If there is no item above, wraps. CCCCAAAAUUUUTTTTIIIIOOOONNNNSSSS +o XXXXmmmmPPPPrrrroooocccceeeessssssssTTTTrrrraaaavvvveeeerrrrssssaaaallll will not allow traversal to a widget in a different shell. +o XXXXmmmmPPPPrrrroooocccceeeessssssssTTTTrrrraaaavvvveeeerrrrssssaaaallll will only allow traversal to widgets that are currently mapped. +o You cannot call XXXXmmmmPPPPrrrroooocccceeeessssssssTTTTrrrraaaavvvveeeerrrrssssaaaallll from inside a focusCallback routine (or you will get a segmentation fault). Page 2 (printed 4/30/98) XXXXmmmmPPPPrrrroooocccceeeessssssssTTTTrrrraaaavvvveeeerrrrssssaaaallll((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmPPPPrrrroooocccceeeessssssssTTTTrrrraaaavvvveeeerrrrssssaaaallll((((3333XXXX)))) RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE Returns True if the setting succeeded. Returns False if the keyboard focus policy is not XXXXmmmmEEEEXXXXPPPPLLLLIIIICCCCIIIITTTT, if there are no traversable items, or if the call to the routine has invalid parameters. RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN XXXXmmmmGGGGeeeettttVVVViiiissssiiiibbbbiiiilllliiiittttyyyy((((3333XXXX)))) and XXXXmmmmIIIIssssTTTTrrrraaaavvvveeeerrrrssssaaaabbbblllleeee((((3333XXXX)))). Page 3 (printed 4/30/98) 
